Miscellaneous Utilities

Sentinel RMS provides various utilities for you and your customers.

The following sections provide an overview of these utilities:

>D: Denotes the audience as you (the developer)

>S: Denotes the audience as system administrator (at the customer site responsible for controlling the License Manager).

>E: Denotes the audience as a licensed application end user

NOTE   The utilities meant for the system administrators and application end users are installed in the \Delivery folder of the Windows installation. You should refer to this section Before you package your licensed application

Utility/Category

Description and Installation on Supported Platforms

Audience

More information

 Sentinel RMS demonstration using the VLS licensing APIs

slmdemo

>Graphical sample program to show basic API functions.

>Windows only: ...\Redistributable\Tools

D

--

For locking code generation

echoid1,2

>Command-line utility to determine a system’s locking code based on its fingerprint.

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

>Linux ARM - .../redistributable/tools

• E - When a locking code of the user system is needed.

• S - When a locking code of the License Manager system is needed.

Refer to the Sentinel RMS SDK System Administrator Help

wechoid

>Graphical utility to determine a system’s locking code based on its fingerprint.

>Windows only: ...\Redistributable\Tools

Same as echoid

Refer to the Sentinel RMS SDK System Administrator Help

echouid1,2

>Command-line utility to generate locking code for upgrade licenses.

>Windows: ..\Redistributable\Tools

>UNIX - .../redistributable/tools

>Linux ARM - .../redistributable/tools

Same as echoid

 

Refer to the Sentinel RMS SDK System Administrator Help or Generating Upgrade Locking Code.

For license code generation (not shipped with the SDK)

lscgen

>Command-line utility to generate license codes, including upgrade licenses.

>Windows and Linux

D

Refer to the WlscGen Help and License Generation Using_lscGen

Wlscgen

>Graphical utility to generate license codes, including upgrade licenses.

>Windows only.

D

Refer to the WlscGen Help and License Generation Using_WlscGen

ulscgen

>Command-line utility to generate upgrade licenses.

>Windows and Linux

D

Refer to Generating Upgrade License Codes 

For license distribution and installation

lslic1

>Command-line utility to add/delete license codes dynamically (without stopping and restarting the License Manager).

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For commuter licenses

lcommute1

>Command-line utility to check-out and check-in license from a License Manager.

>Windows - ...\Redistributable\Tools

>UNIX - .../redistributable/tools

S and E

Refer to the Sentinel RMS SDK System Administrator Help

WCommute

>Graphical utility to check-out and check-in license from a License Manager.

>Windows only: ..\Redistributable\Tools

S and E

Refer to the Sentinel RMS SDK System Administrator Help

rcommute1

>Command-line utility to obtain a commuter locking code for the remote machine and install the remote commuter authorization.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

E

Refer to the Sentinel RMS SDK System Administrator Help

WRCommute

>Graphical utility to obtain a commuter locking code for the remote machine and install the remote commuter authorization.

>Windows only: ..\Redistributable\Tools

E

Refer to the Sentinel RMS SDK System Administrator Help

 

NOTE    WRcommute.exe will crash on Windows 7 Home basic Japanese OS build 7601, due to a known MFC issue.

For Sentinel RMS License Manager

loadls

>Graphical utility to install/uninstall the License Manager into the system services registry.

>Installed with the License Manager (under the \WinNT directory on Windows).

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

lservnt

>Command-line utility to install, start, stop, and obtain status of the Sentinel RMS License Manager service.

>Installed with the License Manager (under the \WinNT directory on Windows).

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

lsmail

>Command-line utility to set the SMTP server, which will be used by the Sentinel RMS License Manager to send alerts via e-mail.

>Installed with the License Manager (under the \WinNT directory on Windows).

>Windows only

S

Refer to the Sentinel RMS SDK System Administrator Help

WlmAdmin

>Graphical utility for adding and managing licenses on the customer site, plus few other administrator tasks related to the License Manager.

>Windows only: ..\Redistributable\Tools

S

Refer to the Sentinel RMS SDK System Administrator Help

lsmon1,2

>Command-line utility to retrieve information about the licenses installed on a particular License Manager.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

lswhere1,2

>Command-line utility to locate the License Managers in a subnet.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

lsver

>A Shell script to obtain the Sentinel RMS SDK version installed on the machine.

>UNIX: ../vendortools

D --

For License Manager redundancy

lspool1

>Command-line utility to view the list of redundant License Managers and perform few other administrator tasks, like adding/removing a License Manager in a redundant License Manager pool.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>From RMS v9.5 onwards, lspool supports license hard limit up to 4,294,967,294. This is applicable for license version 20 (or above). Further, this high value is applicable only when hard limit is used as a quantity.

S

Refer to the Sentinel RMS SDK System Administrator Help

rlftool1

>Command-line utility to create redundant license files (for specifying redundant license configuration)

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

WRlfTool

>Graphical utility to create redundant license configuration file.

>Windows only: ..\Redistributable\Tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For license reservation

Wlsgrmgr

>Graphical utility to generate a group reservation file.

>Windows only: ..\Redistributable\Tools

S

Refer to the Sentinel RMS SDK System Administrator Help

For displaying license code

lsdecode1,2

>Command-line utility to decrypt license codes.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

D

Refer to Decoding (Base) License Codes.

ulsdcod1,2

>Command-line utility to decrypt upgrade license codes.

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

>Linux ARM: .../redistributable/tools

D

For displaying the usage log details

lsusage1,2

>Command-line utility to display the License Manager usage log details (on the customer site).

>Windows: ..\Redistributable\Tools

>UNIX: ../redistributable/tools

S

Refer to the Sentinel RMS SDK System Administrator Help

vusage2

>Command-line utility to display the License Manager usage log details (on the developer site). It can read and display more details than lsusage.

>Windows: ..\VendorTools

>UNIX: ../vendorTools

>Linux ARM: ../vendorTools

D

Refer to "Displaying Encrypted/Readable License Manager Log File"

For revoking active licenses

Revocation tool

>Used to revoke active licenses from the EMS portal.

>Windows: ..\Redistributable\Tools

>LINUX: ../redistributable/tools

E

Refer to Sentinel RMS SDK System Administrator Help

1 For Linux, we have also provided a 64-bit variant of this utility. For macOS, only 64-bit variants are provided.
2 For Linux ARM, we have also provided a 64-bit variant of this utility.